[iOS only] Add the ability to intercept errors from native side and forward them to JS console #5622

alwx · 2026-02-05T14:09:22Z

📢 Type of change

Bugfix
New feature
Enhancement
Refactoring

📜 Description

Was born as an attempt to fix #5566 and turned out to be a good idea in general.

This PR makes it possible to intercept native logs (currently only works with iOS and only with a patch, see notes below) and forward them to JS console:

Sentry.init({
  onNativeLog: ({ level, component, message }) => {
    // Use logWithoutTracing to avoid feedback loops with Sentry's console integration
    logWithoutTracing(`[Sentry Native] [${level.toUpperCase()}] [${component}] ${message}`);
  },
  debug: true,
}

(that only works when debug is set to true)

This PR makes it so that instead of handling HTTP code 413 somehow separately we can allow users to just get native logs in their JS console and see code 413 or any other error codes themselves. Filtering per level or component is also possible.

Notes

⚠️ Currently is works only on iOS and with a patch (I'll make a PR to iOS if we decide to move further with that).

Here is the patch (save it to setOutput.patch and apply with git apply setOutput.patch before building the app):

From: Sentry RN SDK
Subject: [PATCH] feat: Expose setOutput API for hybrid SDKs

Expose `setOutput` in `SentrySDKLog` as a public API, allowing hybrid SDKs
to intercept SDK log messages and forward them to their consoles.

Related: sentry-react-native#5566
---
 Sources/Swift/Core/Tools/SentrySDKLog.swift | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/Sources/Swift/Core/Tools/SentrySDKLog.swift b/Sources/Swift/Core/Tools/SentrySDKLog.swift
index abcdef1..1234567 100644
--- a/Sources/Swift/Core/Tools/SentrySDKLog.swift
+++ b/Sources/Swift/Core/Tools/SentrySDKLog.swift
@@ -51,10 +51,14 @@ typealias SentryLogOutput = ((String) -> Void)
         }
         return isDebug && level.rawValue >= diagnosticLevel.rawValue
     }
-
-    #if SENTRY_TEST || SENTRY_TEST_CI
-
-    static func setOutput(_ output: @escaping SentryLogOutput) {
+
+    /// Sets a custom log output handler. This allows hybrid SDKs (React Native, Flutter, etc.)
+    /// to intercept SDK log messages and forward them to their respective consoles.
+    @objc
+    public static func setOutput(_ output: @escaping (String) -> Void) {
         logOutput = output
     }
-
+
+    #if SENTRY_TEST || SENTRY_TEST_CI
+
     static func getOutput() -> SentryLogOutput {
         return logOutput
     }
--
2.39.0

📝 Checklist

I added tests to verify changes
No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
I updated the docs if needed.
I updated the wizard if needed.
All tests passing
No breaking changes

🔮 Next steps

github-actions · 2026-02-05T14:09:43Z

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

[iOS only] Add the ability to intercept errors from native side and forward them to JS console by alwx in #5622

chore(deps): update Android SDK to v8.32.0 by github-actions in #5633
chore(deps): bump getsentry/craft from 2.20.1 to 2.21.2 by dependabot in #5630
chore(deps): bump getsentry/craft/.github/workflows/changelog-preview.yml from 2.20.1 to 2.21.2 by dependabot in #5632
chore(deps): bump github/codeql-action from 4.32.0 to 4.32.2 by dependabot in #5631
feat(feedback): Add autoCorrect and spellCheck config to FeedbackWidget by sbs44 in #5627
fix(feedback): Deep merge custom styles with defaults in FeedbackWidget by sbs44 in #5625

_{🤖 This preview updates automatically when you update the PR.}

github-actions · 2026-02-05T14:10:03Z

	Fails
🚫	Pull request is not ready for merge, please add the "ready-to-merge" label to the pull request
🚫	Please consider adding a changelog entry for the next release.

	Warnings
⚠️	🤖 Replay Stubs Check ✅ No changes detected in replay-stubs.jar All file contents are identical (verified by SHA-256 hash comparison).

Instructions and example for changelog

Please add an entry to CHANGELOG.md to the "Unreleased" section. Make sure the entry includes this PR's number.

Example:

## Unreleased

### Features

- An (ongoing) experiment with adding native logs listener ([#5622](https://github.com/getsentry/sentry-react-native/pull/5622))

If none of the above apply, you can opt out of this check by adding #skip-changelog to the PR description or adding a skip-changelog label.

Generated by 🚫 dangerJS against 365ab16

lucas-zimerman · 2026-02-10T14:32:18Z

packages/core/src/js/NativeLogListener.ts

+  if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
+    debug.log('Native log listener is only supported on iOS and Android.');


This will work on the future once we have support for Android and iOS. For the time being, this PR is only adding support for iOS

Suggested change

if (Platform.OS !== 'ios' && Platform.OS !== 'android') {

debug.log('Native log listener is only supported on iOS and Android.');

if (Platform.OS !== 'ios') {

debug.log('Native log listener is only supported on iOS.'');

lucas-zimerman · 2026-02-10T14:40:43Z

packages/core/src/js/NativeLogListener.ts

+  const prefix = `[Sentry] [${log.level.toUpperCase()}] [${log.component}]`;
+  const message = `${prefix} ${log.message}`;
+
+  switch (log.level.toLowerCase()) {


It would be nice if defaultNativeLogHandler doesn't create any events when captureConsoleIntegration is added as an integration.
Q: Shouldn't we use debug instead of console here?

lucas-zimerman

So far it's looking good! I left a few suggestions that would be nice to be addressed before merging.

alwx added 3 commits February 9, 2026 13:40

An (ongoing) experiment with adding native logs listener

59703cf

NativeLogListener.ts

81c05c6

Log forwarder

f369c1d

alwx force-pushed the alwx/experiment/native-logs branch from 2108fe1 to f369c1d Compare February 9, 2026 12:40

alwx added 2 commits February 9, 2026 14:49

Fixes

365ab16

Fixes

355cfb2

alwx changed the title ~~WIP: An (ongoing) experiment with adding native logs listener~~ Native logs listener Feb 10, 2026

alwx changed the title ~~Native logs listener~~ Native logs listener to intercept errors from native side and forward them to JS console Feb 10, 2026

alwx changed the title ~~Native logs listener to intercept errors from native side and forward them to JS console~~ Intercept errors from native side and forward them to JS console Feb 10, 2026

alwx changed the title ~~Intercept errors from native side and forward them to JS console~~ Add the ability to intercept errors from native side and forward them to JS console Feb 10, 2026

alwx self-assigned this Feb 10, 2026

alwx marked this pull request as ready for review February 10, 2026 10:51

alwx requested review from antonis and lucas-zimerman as code owners February 10, 2026 10:51

alwx added the ready-to-merge Triggers the full CI test suite label Feb 10, 2026

alwx changed the title ~~Add the ability to intercept errors from native side and forward them to JS console~~ [iOS only] Add the ability to intercept errors from native side and forward them to JS console Feb 10, 2026

lucas-zimerman reviewed Feb 10, 2026

View reviewed changes

lucas-zimerman requested changes Feb 10, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[iOS only] Add the ability to intercept errors from native side and forward them to JS console #5622

[iOS only] Add the ability to intercept errors from native side and forward them to JS console #5622

Uh oh!

alwx commented Feb 5, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 5, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 5, 2026 •

edited

Loading

🤖 Replay Stubs Check

Uh oh!

lucas-zimerman Feb 10, 2026

Uh oh!

lucas-zimerman Feb 10, 2026

Uh oh!

lucas-zimerman left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
		debug.log('Native log listener is only supported on iOS and Android.');

Uh oh!

[iOS only] Add the ability to intercept errors from native side and forward them to JS console #5622

Are you sure you want to change the base?

[iOS only] Add the ability to intercept errors from native side and forward them to JS console #5622

Uh oh!

Conversation

alwx commented Feb 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📢 Type of change

📜 Description

Notes

📝 Checklist

🔮 Next steps

Uh oh!

github-actions bot commented Feb 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Semver Impact of This PR

Uh oh!

github-actions bot commented Feb 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🤖 Replay Stubs Check

Instructions and example for changelog

Uh oh!

lucas-zimerman Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

lucas-zimerman Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

lucas-zimerman left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

alwx commented Feb 5, 2026 •

edited

Loading

github-actions bot commented Feb 5, 2026 •

edited

Loading

github-actions bot commented Feb 5, 2026 •

edited

Loading